package com.cencat.driver.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.driver.entity.Driver;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 司机数据访问层
 * 
 * @author cencat
 * @version 1.0
 * @since 2024-12-19
 */
@Mapper
public interface DriverMapper extends BaseMapper<Driver> {

    /**
     * 分页查询司机列表
     * 
     * @param page 分页参数
     * @param driverStatus 司机状态
     * @param workStatus 工作状态
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 司机列表
     */
    IPage<Driver> selectDriverPage(IPage<Driver> page, 
                                   @Param("driverStatus") Integer driverStatus,
                                   @Param("workStatus") Integer workStatus,
                                   @Param("startTime") LocalDateTime startTime,
                                   @Param("endTime") LocalDateTime endTime);

    /**
     * 根据手机号查询司机
     * 
     * @param phone 手机号
     * @return 司机信息
     */
    Driver selectByPhone(@Param("phone") String phone);

    /**
     * 根据身份证号查询司机
     * 
     * @param idCard 身份证号
     * @return 司机信息
     */
    Driver selectByIdCard(@Param("idCard") String idCard);

    /**
     * 根据驾驶证号查询司机
     * 
     * @param licenseNo 驾驶证号
     * @return 司机信息
     */
    Driver selectByLicenseNo(@Param("licenseNo") String licenseNo);

    /**
     * 查询在线司机列表
     * 
     * @param longitude 经度
     * @param latitude 纬度
     * @param radius 半径(公里)
     * @param limit 限制数量
     * @return 在线司机列表
     */
    List<Driver> selectOnlineDrivers(@Param("longitude") Double longitude,
                                     @Param("latitude") Double latitude,
                                     @Param("radius") Double radius,
                                     @Param("limit") Integer limit);

    /**
     * 查询空闲司机列表
     * 
     * @param longitude 经度
     * @param latitude 纬度
     * @param radius 半径(公里)
     * @param limit 限制数量
     * @return 空闲司机列表
     */
    List<Driver> selectIdleDrivers(@Param("longitude") Double longitude,
                                   @Param("latitude") Double latitude,
                                   @Param("radius") Double radius,
                                   @Param("limit") Integer limit);

    /**
     * 统计司机数量
     * 
     * @param driverStatus 司机状态
     * @param workStatus 工作状态
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 司机数量
     */
    Long countDrivers(@Param("driverStatus") Integer driverStatus,
                      @Param("workStatus") Integer workStatus,
                      @Param("startTime") LocalDateTime startTime,
                      @Param("endTime") LocalDateTime endTime);

    /**
     * 查询司机统计数据
     * 
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计数据
     */
    List<Map<String, Object>> selectDriverStatistics(@Param("startTime") LocalDateTime startTime,
                                                      @Param("endTime") LocalDateTime endTime);

    /**
     * 更新司机状态
     * 
     * @param driverId 司机ID
     * @param driverStatus 司机状态
     * @param updateTime 更新时间
     * @return 更新行数
     */
    int updateDriverStatus(@Param("driverId") Long driverId,
                           @Param("driverStatus") Integer driverStatus,
                           @Param("updateTime") LocalDateTime updateTime);

    /**
     * 更新司机工作状态
     * 
     * @param driverId 司机ID
     * @param workStatus 工作状态
     * @param updateTime 更新时间
     * @return 更新行数
     */
    int updateWorkStatus(@Param("driverId") Long driverId,
                         @Param("workStatus") Integer workStatus,
                         @Param("updateTime") LocalDateTime updateTime);

    /**
     * 更新司机位置
     * 
     * @param driverId 司机ID
     * @param longitude 经度
     * @param latitude 纬度
     * @param updateTime 更新时间
     * @return 更新行数
     */
    int updateDriverLocation(@Param("driverId") Long driverId,
                             @Param("longitude") Double longitude,
                             @Param("latitude") Double latitude,
                             @Param("updateTime") LocalDateTime updateTime);

    /**
     * 批量更新司机状态
     * 
     * @param driverIds 司机ID列表
     * @param driverStatus 司机状态
     * @param updateTime 更新时间
     * @return 更新行数
     */
    int batchUpdateDriverStatus(@Param("driverIds") List<Long> driverIds,
                                @Param("driverStatus") Integer driverStatus,
                                @Param("updateTime") LocalDateTime updateTime);

    /**
     * 查询司机评分统计
     * 
     * @param driverId 司机ID
     * @return 评分统计
     */
    Map<String, Object> selectDriverRatingStats(@Param("driverId") Long driverId);

    /**
     * 查询司机收入统计
     * 
     * @param driverId 司机ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 收入统计
     */
    Map<String, Object> selectDriverIncomeStats(@Param("driverId") Long driverId,
                                                 @Param("startTime") LocalDateTime startTime,
                                                 @Param("endTime") LocalDateTime endTime);

    /**
     * 查询司机订单统计
     * 
     * @param driverId 司机ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 订单统计
     */
    Map<String, Object> selectDriverOrderStats(@Param("driverId") Long driverId,
                                                @Param("startTime") LocalDateTime startTime,
                                                @Param("endTime") LocalDateTime endTime);

    /**
     * 查询司机工作时长统计
     * 
     * @param driverId 司机ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 工作时长统计
     */
    Map<String, Object> selectDriverWorkTimeStats(@Param("driverId") Long driverId,
                                                   @Param("startTime") LocalDateTime startTime,
                                                   @Param("endTime") LocalDateTime endTime);

    /**
     * 查询最近活跃司机
     * 
     * @param limit 限制数量
     * @return 活跃司机列表
     */
    List<Driver> selectRecentActiveDrivers(@Param("limit") Integer limit);

    /**
     * 查询司机排行榜
     * 
     * @param type 排行类型 1-订单数量 2-收入金额 3-评分
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param limit 限制数量
     * @return 排行榜数据
     */
    List<Map<String, Object>> selectDriverRanking(@Param("type") Integer type,
                                                   @Param("startTime") LocalDateTime startTime,
                                                   @Param("endTime") LocalDateTime endTime,
                                                   @Param("limit") Integer limit);

}